package com.micro.ai.template.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.micro.ai.template.entity.TemplateVersion;

import java.util.List;

/**
 * 模板版本Service
 *
 * @author micro-ai
 * @since 0.0.1
 */
public interface TemplateVersionService extends IService<TemplateVersion> {

    /**
     * 创建新版本
     *
     * @param templateVersion 版本信息
     * @return 创建的版本
     */
    TemplateVersion createVersion(TemplateVersion templateVersion);

    /**
     * 获取模板的所有版本
     *
     * @param templateId 模板ID
     * @param page 分页参数
     * @return 版本列表
     */
    IPage<TemplateVersion> getVersionsByTemplateId(String templateId, Page<TemplateVersion> page);

    /**
     * 获取模板的活跃版本
     *
     * @param templateId 模板ID
     * @return 活跃版本
     */
    TemplateVersion getActiveVersion(String templateId);

    /**
     * 激活版本
     *
     * @param versionId 版本ID
     */
    void activateVersion(String versionId);

    /**
     * 获取模板的稳定版本列表
     *
     * @param templateId 模板ID
     * @return 稳定版本列表
     */
    List<TemplateVersion> getStableVersions(String templateId);

    /**
     * 比较两个版本
     *
     * @param versionId1 版本1 ID
     * @param versionId2 版本2 ID
     * @return 比较结果
     */
    Object compareVersions(String versionId1, String versionId2);

    /**
     * 回滚到指定版本
     *
     * @param templateId 模板ID
     * @param versionId 目标版本ID
     */
    void rollbackToVersion(String templateId, String versionId);
}

